ENHANCEMENTS 
TO BASIC 




ENHANCEMENTS TO BASIC INSTRUCTIONS FOR PREPARATION AND USE 


FOR ALL ATARIS WITH A MINIMUM OF 4BK RAH AND REVISION A, B, OR C BASIC 

PLEASE BE SURE TO READ ALL THE INSTRUCTIONS BEFORE USING ENHANCEMENTS TO 
BASIC, IMPORTANT HINTS AND PROGRAMMING INFORMATION ARE SCATTERED THROUGHOUT 
THE MANUAL, AND YOU MAY MISS SOMETHING IMPORTANT IF YOU FAIL TO READ THE 
ENTIRE MANUAL THOROUGHLY. 


CQPYRI6HT CAUTION 

THIS PROGRAM IS PROTECTED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES OF 
AMERICA. EACH PROGRAM HAS A UNIGUE SERIAL NUMBER WHICH IS REGISTERED TO YOU, 
THE PURCHASER. YOU ARE GRANTED THE RIGHT TO MAKE COPIES AS NECESSARY FOR 
YOUR PERSONAL USE. COPIES FOR ANY OTHER PURPOSE ARE A VIOLATION OF THE U.S. 
COPYRIGHT LAWS. PLEASE USE CARE IN NOT ALLOWING OTHERS TO MAKE COPIES OF 
YOUR PROGRAM SINCE THIS MIGHT POSSIBLY LEAD TO COPIES WHICH ARE REGISTERED 
TO YOU BEING ILLEGALLY DISTRIBUTED. 

WE FEEL THAT WE HAVE PROVIDED YOU WITH A QUALITY PROGRAM AT A VERY REASONABLE 
PRICE. IF, FOR ANY REASON, YOU DO NOT AGREE, PLEASE CONTACT US. HE VALUE YOUR 
BUSINESS AND ARE WILLING TO TRY TO RESOLVE ANY PROBLEMS THAT MAY ARISE IN 
ORDER TO KEEP YOU AS A SATISFIED CUSTOMER. 


INTRODUCTION 


As all loyal ATARI owners know, ATARI BASIC is one of the most convenient 
programming languages available for the ATARI hose computer. The error 
checking at the time a prograa line is entered has saved aany programmers 
hours of prograa debugging. It is, in short, a very user friendly and easy 
to use programming language. 

ATARI BASIC, however, does have some drawbacks and liaitations. It lacks 
coaaands to access the common DOS functions. It cannot renumber program 
lines. It cannot delete blocks of prograa lines. It has no trace function 
to aid in debugging. Worst of all, when you are programming with ATARI BASIC, 
it sometimes locks up causing all your programming efforts to be lost! 

ENHANCEMENTS TO BASIC will help to eliminate some of the drawbacks and 
limitations of ATARI BASIC. It will give you immediate mode commands to 
access aany DOS functions. It will enable you to trace your program flow for 
debugging and analyzing complicated programs. It has a renumber function, 
a block delete function, automatic line numbering, a protect function to 



save files in an executable but unreadable foraat, and *uch aore. But best 
at all, ENHANCEMENTS TO BASIC will help to eli»inate the editing lockup 
tendency which has been a problea tor aany years on the 800 and has recently 
shown up in a slightly ditferent for* on the 800XL. In short, ENHANCEMENTS 
TO BASIC aakes ATARI BASIC into an excellent, user friendly, progra#*ing 
language. 


• PREPARINS YOUR COPY OF ENHANCEMENTS TO BASIC 

SEVERAL SECTIONS OF STARTUP INSTRUCTIONS ARE PRESENTED HERE. BE SURE TO FIND 
THE INSTRUCTION SET WHICH IS PERTINENT TO THE TYPE OF DOS YOU ARE USING. 

IF YOU ARE PROFICIENT IN USING YOUR DOS YOU HAY FIND THE GENERALIZED 
INSTRUCTIONS AT THE END OF THIS SECTION TO BE SUFFICIENT FOR YOUR USE. 

*»m*m»m***t#mH*i*f*f*fff*f*m****ti**tftttftfti*«i«ti*{*i*ftftft«* 

STARTUP INSTRUCTIONS FOR ATARI DOS 2,OS AND ATARI DOS 2.5 


1. Turn on your disk drive and aonitor or television. 

2. When the busy light on the disk drive goes out, open the door and 
insert a copy of the DOS you wish to use with ENHANCEHENTS TO BASIC. 

3. Close the door an your disk drive. 

4. (FOR 800 USERS ONLY) Open the door on your co*puter, insert the 
ATARI BASIC cartridge, and close the door. 

5. Turn on your coaputer. 

6. When the READY proapt appears, type PRINT F'EEK(43234) [RETURN] and 
write down the nuaber displayed. This nuaber sust be 96, 162, or 
234. If you get any other value, recheck this step. 

7. Type DOS [RETURN]. 

8. When the busy light on the disk drive goes out reaove your DOS 
Blaster diskette and insert a blank diskette. 

9. Type I [RETURN]. (DOS 2.5 users - type P [RETURN] if you wish to 
use single density foraat.) 

10. Type 1 [RETURN]. (Be sure to use the nuaber 1 and not the letter I.) 

11. Type Y [RETURN], 

12. When the busy light on the disk drive goes out type H [RETURN]. 

13. Type 1 [RETURN]. (Be sure to use the nuaber 1 and not the letter I.) 

14. Type Y [RETURN]. 

15. When the busy light on the disk drive goes out reaove the diskette 
just foraatted and insert your ENHANCEHENTS TO BASIC aaster disk. 

16. Type 0 [RETURN], (Be sure to use letter 0 not nuaber 0.) 

17. If the nuaber you wrote down earlier was 162 answer the proapt 
with BASICA [RETURN]. Otherwise answer the proapt with BASICBC 
[RETURN], 



18. Press [RETURN] again. 

19. When the busy light on the disk drive goes out reaove the 
ENHANCEMENTS TO BASIC waster diskette and insert the diskette you 
just formatted, 

20. Press [RETURN!. 

21. When the busy light on the disk drive goes out type L [RETURN]. 

22. Answer the proapt with BASIC* [RETURN!. 

23. When the busy light on the disk drive goes out you should see the 
ENHANCEMENTS TO BASIC title proapt. If you do not, an error has 
occurred and you Bust start over at step one. 

24. Turn off your coaputer. (If you are using an ATARI 800 reaove the 
BASIC cartridge.) 

25. Turn your coaputer back on. The ENHANCEMENTS TO BASIC prograa 
should load and run. 

26. To run ENHANCEMENTS TO BASIC in the future, you need only boot this 
working diskette. You aay, if you wish, sake backup copies of this 
diskette for your personal use. 

27. Under DOS 2.OS the !DDF coaaand is not available, 

28. If you use the IDOS coaaand to call the DOS aenu you will not be 
able to return to BASIC in the noraal aanner. You aust return to 
BASIC by typing M [RETURN] and answering the 'RUN AT WHAT ADDRESS' 
proapt with 9333 [RETURN!. If you have a MEM.SAV file on your 
diskette you will return to BASIC with your prograa intact. DO NOT 
PRESS [SYSTEM RESET! WHILE IN DOS. TO DO SO WILL USUALLY CAUSE A 
SYSTEM LOCKUP! 

29. You can create a MEM.SAV file on the diskette in drive 1 froa 
ENHANCED BASIC by entering the coaaand IRUNAT $1746. 

30. Since aost DOS coaaands are available froa ENHANCED BASIC, the best 
choice would be to avoid DOS calls coapletely while prograaaing 

in BASIC. If you need to use DOS, save your prograa first, then 
call DOS. This will prevent accidental loss of prograas or data. 

**************************************************************************** 

STARTUP INSTRUCTIONS FOR ATARI DOS 3 


1. Turn on your disk drive and aonitor or television. 

2. When the busy light on the disk drive goes out, open the door and 
insert your aaster copy of ATARI DOS 3. 

3. Close the door on your disk drive. 

4. (FOR 800 USERS ONLY) Open the door on your coaputer, insert the 
ATARI BASIC cartridge, and close the door. 

5. Turn on your coaputer. 

6. When the READY proapt appears type DOS [RETURN!. 

7. Type T. 

8. Type PRINT PEEK (43234! [RETURN!. 



-9. Write down the nuaber which is displayed. This value aust be 96, 

162, or 234. If you get any other value recheck this step. 

'10. Type DOS [RETURN]. 

'11. Type I. (Be sure to use the letter I and not the nuaber 1.) 

'12. Type 1 [RETURN], (Be sure to use the nuaber 1 and not the letter I.) 

-13. Type 1 [RETURN], (Be sure to use the nuaber 1 and not the letter I.) 

,14. Reaove the diskette fora drive 1 and insert a blank diskette. 

-15. Type Y [RETURN]. 

-16. Type N [RETURN] [RETURN]. 

^ 17. When the busy light on the disk drive goes out reaove the diskette 
just foraatted and insert your DOS 3 aaster diskette. 

^18. Press [ESCAPE! and wait for the busy light on the drive to go out. 

19. Type ft and wait for the busy light on the disk drive to go out. 

^20. Type 1 [RETURN]. (Be sure to use the nuaber 1 and not the letter I.) 

^21. If the nuaber you wrote down earlier was 162 answer the proapt 

with BfiSICft [RETURN]. Otherwise answer with BASICBC [RETURN]. 

-•22. Type 1 [RETURN]. (Be sure to use the nuaber 1 and not the letter I.) 

r23, ftnswer the proapt with the saae response as in step 21. 

-24. Reaove your DOS 3 aaster diskette and insert your ENHANCEMENTS TO 
BASIC aaster diskette. 

-25. Press [RETURN!. 

-26. When the busy light on the disk drive goes out reaove your 

ENHANCEMENTS TO BASIC aaster diskette and insert the diskette you 
just foraatted. 

-27. Press [RETURN]. 

28. When the busy light on the disk drive goes out reaove the diskette 
and insert your DOS 3 aaster diskette. 

29. Type N [RETURN!. 

30. Nhen the busy light on the disk drive goes out reaove your DOS 3 
aaster diskette and insert the diskette you reaoved in step 28. 

31. Type L 

32. Type BASIC* [RETURN!. 

33. Type Y [RETURN]. 

34. Type Y [RETURN]. 

35. Nhen the busy light on the disk drive goes out you should see the 
ENHANCEMENTS TO BASIC title proapt. If you do not, an error has 
occurred and you aust start over at step one. 

36. Turn off your cosputer. (If you are using an ATARI 800 reaove the 
BASIC cartridge.) 

37. Turn your coaputer back on. ENHANCEMENTS TO BASIC should load 
and run, 

38. To run ENHANCEMENTS TO BASIC in the future you need only boot 
this working diskette. You aay, if you wish, aake backup copies of 
this diskette for your personal use. 

39. If you wish to be able to call DOS 3 froa ENHANCED BASIC with the 
!DOS coaaand you aust copy the KCP.SYS and KCP0VER.SYS files froa 



your DOS 3 taster diskette to your ENHANCEMENTS TO BASIC working 
diskette. See your DOS 3 tanuai for instructions on how to do this. 
CAUTION - IF YOU CALL DOS 3 FROM ENHANCED BASIC YOU MUST RETURN TO 
BASIC BY USING THE G (GO TO ADDRESS! OPTION AND ANSWERING THE PROMPT 
WITH 9333. WITH THIS METHOD ANY BASIC PROGRAM IS CLEARED FROM MEMORY. 
SINCE MOST DOS 3 FUNCTIONS ARE AVAILABLE FROM ENHANCED BASIC, WE 
RECOMMEND THAT YOU DO NOT USE THE ‘DOS COMMAND WHEN USING DOS 3. 

STARTUP INSTRUCTIONS FOR OSS DOS XL 


1. Turn on your disk drive and aonitor or television. 

2. When the busy light on the disk drive goes out, open the door and 
insert your single density taster copy of OSS DOS XL. If you do not 
have a taster copy of DOS XL, you aust take certain that the files 
DOS.SYS, INIT.COM, CQPY.COM, and MENU.COM are on the DOS XL 
diskette you insert. 

3. Close the door on your disk drive. 

4. (FOR 800 USERS ONLY! Open the door on your coaputer, insert the 
ATARI BASIC cartridge, and close the door, 

5. Turn on your coaputer. 

6. If you used a taster copy of BOS XL you should now see the DOS XL 
nenu. If you see the READY proapt instead, type DOS [RETURN], 

7. Type T. 

8. Type PRINT PEEK (43234) [RETURN], 

9. Write down the nuaber which is displayed. This value aust be 96, 

162, or 234. If you get any other value recheck this step. 

10. Type DOS [RETURN!. 

11. Type I. (Be sure to use the letter I and not the nuaber 1.) 

12. When the busy light on the disk drive goes out type 2 [RETURN], 

13. Type 1 [RETURN], (Be sure to use the nuaber ! and not the letter 1.! 

14. Reaove the diskette froa drive 1 and insert a blank diskette. 

15. Type Y [RETURN], 

16. When the busy light on the disk drive goes out press [RETURN]. 

17. Type 4 [RETURN]. 

IB, Reaove the diskette just foraatted and insert your DOS XL aaster 
diskette into drive 1. 

19. Type C. 

20. If the nuaber you wrote down earlier was 162, answer the FROM FILE: 
and TO FILE: proapts with BASICA [RETURN], Otherwise answer with 
BASICBC [RETURN!. 

21. Type Y [RETURN], 

22. When the busy light on the disk drive goes out reaove your DOS XL 
aaster diskette and insert your ENHANCEMENTS TO BASIC aaster disk, 

23. Press [RETURN], 



24. Type Y [RETURN]. 

25. Nhen the busy light on the disk drive goes out re*ove your 
ENHANCEMENTS TO BASIC taster diskette and insert the diskette you 
previously foraatted. 

26. Press [RETURN], 

27. When the busy light on the disk drive goes out press [RETURN] twice. 

28. You should not* see the DOS XL tenu and should have the diskette 
you previously foraatted in drive 1, 

29. Type L. 

30. Answer the prospt with BASIC* [RETURN]. 

31. Nhen the busy light on the disk drive goes out you should see the 
ENHANCEMENTS TO BASIC title proapt. IT you do not, an error has 
occurred and you aust start over at step one. 

32. Turn oTT your coaputer. (If you are using an ATARI 800 reaove the 
BASIC cartridge.) 

33. Turn your coaputer back on. ENHANCEMENTS TO BASIC should load 
and run. 

34. To run ENHANCEMENTS TO BASIC in the future you need only boot 
this working diskette. You aay, if you wish, sake backup copies at 
this diskette for your personal use. 

35. If you use the !DOS coaaand to access DOS XL froa ENHANCED BASIC 
you will not be able to return to BASIC in the noraal way. You aust 
type RUN 9333 at the Dl: proapt or 9333 in response to the 6 aenu 
option (Bo to address). These aethods will erase any BASIC prograa 
in aeaory. If you are certain you have not done anything while in 
DOS XL to daaage your BASIC prograa, you aay retrn to BASIC with 
the [SYSTEM RESET] key. However, if your BASIC prograa is daaaged a 
systea lockup will result. As a general rule, intrinsic DOS XL 
coaaands will not daaage a BASIC prograa, but extrinsic DOS XL 
coaaands alaost always will. Also, if the DOS XL HENU.COM file 

is loaded BEFORE you begin prograaaing, it will be available 
without daaage to BASIC. 

36. Nhen using DOS XL with ENHANCEMENTS TO BASIC the HENU.COM file 
will not load autoaatically. If you wish to load it you aust type 
DOS [RETURN] and then type MENU at the Dl: proapt. Reaeaber that 
the first tiae HENU.COM is loaded it is an extrinsic coaaand and 
you aust not return to BASIC with the [SYSTEM RESET] key or a 
systea lockup will result. 

37. If you are using DOS XL on an 800XL coaputer you aay use the 
D0SXL.XL file to increase user aeaory. See your DOS XL aanual for 
additional inforaation. 

38. If you wish to use ENHANCEMENTS TO BASIC in double density, sisply 
use the DOS XL SDC0PY coaaand to copy your ENHANCEMENTS TO BASIC 
AUTORUN.SYS file to a double density diskette. 

39. Since aost DOS XL coaaands are available froa ENHANCED BASIC, we 
recoaaend that you avoid DOS calls entirely while prograaaing in 



BASIC. Save your prograa to disk first, then call DOS XL. This 
could prevent an accident which aay cause you to lose prograas or 
valuable data. 

40. The !EDF and !DDF coaaands are not available with DOS XL. You aust 
use the appropriate DOS XL coaaands instead. 

f*mt{HH#t«f*mt4H*mf***»**it****f*t*t*m*f*ttt**fftfH»«**tm*mf 

STARTUP INSTRUCTIONS FOR SPARTADQS 


1. Turn on your disk drive and aonitor or television. 

2. When the busy light on the disk drive goes out, open the door and 
insert your aaster copy of SPARTADOS. 

3. Close the door on your disk drive. 

4. (FOR 800 USERS ONLY) Open the door on your coaputer, insert the 
ATARI BASIC cartridge, and dose the door. 

5. Turn on your coaputer. 

6. Follow the SPARTADOS routine to set the tiae and date. 

7. When you see the Dll proapt type CAR [RETURN!. 

8. Type PRINT PEEK (43234) [RETURN] and write down the nuaber which is 
displayed. This nuaber aust be 96, 162, or 234. If you get any 
other value, recheck this step. 

9. Type DOS [RETURN]. 

10. Type FORMAT [RETURN]. 

11. When the busy light on the disk drive goes out type Y, 

12. Press [RETURN3 

13. Type 1. (Be sure to use the nuaber 1 and not the letter I.) 

14. Type 1. (Be sure to use the nuaber 1 and not the letter I.) 

15. Type 1. (Be sure to use the nuaber 1 and not the letter I.) 

16. Type EBASIC [RETURN]. 

17. Type N. 

18. Remove your SPARTADOS aaster and insert a blank disk into drive 1. 

19. Press [RETURN]. 

20. When the busy light on the disk drive goes out press [ESCAPE]. 

21. Reaove the diskette just foraatted and insert your SPARTADOS 
aaster diskette into drive i. 

22. Type SPC0PY [RETURN]. —~ 

23. When the busy light on the disk drive goes out reaove your SPARTADOS 
aaster diskette and insert your ENHANCEMENTS TO BASIC aaster 
diskette into drive 1. 

24. Press [START]. 

25. If the nuaber you previously wrote down was 162 press the space 
bar. If the nuaber was 96 or 234 press [SELECT] and then press 
the space bar. 

26. Press [START] twice. 

27. When the busy light on the disk drive goes out reaove your 



ENHANCEMENTS TO BASIC siaster diskette and insert the diskette you 
previously -formatted into drive 1, 

28. Press [START] and wait for the busy light on the disk drive to go out. 

29. Press [OPTION] then type RENAME BASIC* BASIC.COM [RETURN], 

30. When the busy light on the disk drive goes out type BASIC [RETURN], 

31. When the busy light on the disk drive goes out you should see the 
ENHANCEMENTS TO BASIC title proapt. If you do not, an error has 
occurred and you eust start over at step one. 

32. Press [SYSTEM RESET] and type DOS [RETURN!. 

33. Type ERASE BASIC.COM [RETURN!. 

34. When the busy light on the disk drive goes out type 
RENAME AUTORUN,SYS BAS3C.COM [RETURN]. 

35. When the busy light on the disk drive goes out type 
COPY E: D:STARTUP.BAT [RETURN!. 

36. Type BASIC [RETURN!. 

37. Hold down the [CTRL! key and press the 3 key. 

38. When the busy light on the disk drive goes out turn off your 
cosputer. (If you are using an ATARI 800 re*ove the BASIC 
cartridge at this time.) 

39. Turn your coaputer back on. 

40. The ENHANCEMENTS TO BASIC prograa should load and run. 

41. If you call SPARTADOS froa ENHANCED BASIC with the '.DOS coaaand, 
you can return to BASIC with your prograa intact as long as you 
do not use any of the coaaands which are classified as external. 

42. With the exception of the DIR coaaand, DOS coaaands are not 
available from ENHANCED BASIC when using SPARTADOS. 

o******t*mimtt*****m**t******iHHmmHH**H*«*»*******t****m* 

THE FOLLOWING ARE 6ENERAL INSTRUCTIONS WHICH SHOULD BE USED ONLY IF YOUR 
PARTICULAR DOS NAS NOT PREVIOUSLY COVERED OR IF YOU HAVE A SLIBHTLV DIFFERENT 
REVISION OF A DOS WHICH HAS BEEN COVERED WITH SPECIFIC INSTRUCTIONS. SINCE 
THESE INSTRUCTIONS ARE NOT SPECIFIC TO ANY PARTICULAR DOS, YOU NILL HAVE TO 
RELY ON YOUR DOS USER'S MANUAL FOR ADDITIONAL INFORMATION. 


1. Turn on your disk drive and aonitor or television. 

2. When the busy light goes out, open the door and insert a copy of 
the DOS you wish to use with ENHANCEMENTS TO BASIC. 

3. Close the door on your disk drive. 

4. IFOR BOO USERS ONLY) Open the door on your coaputer, insert the 
ATARI BASIC cartridge, and close the door. 

5. Turn on your coaputer. 

6. When the ready proapt appears, type PEEK(43234) [RETURN!. 

7. Write down the nuaber which appears on your screen. 

B. Type DOS [RETURN] 

9. Using the instructions appropriate to the DOS you are using, you 


Bust non format a blank diskette and write DOS to it. If your DOS 
and disk drive have double density capability, you nay foraat in 
double density to conserve disk space. 

10. Again using the instructions appropriate to your DOS, you Bust 
copy a file froa the ENHANCEMENTS TO BASIC aaster diskette to the 
diskette you just fornatted. If the nuiber you previously wrote 
down was 162 you Bust copy the BASICA file to your formatted 
diskette. If the number was 96 or 234 you sust copy the BASICBC 
file to your formatted diskette. 

The files of the ENHANCEMENTS TO BASIC naster diskette are in 
ATARI DOS 2.OS foraat and can be read directly by ATARI DOS 2.OS, 
ATARI DOS 2.5, and OSS DOS XL. If you are using another DOS you 
aay have to use a conversion prograa which is supplied with your 
DOS in order to read the files on your aaster diskette and save 
the® to your working diskette. In this case, be sure to follow 
the instructions for your particular conversion prograa carefully. 

11. Once you haye copied the proper file onto your working diskette, 
you aust load and run it. Reaeaber, this is a binary file and 
aust be loaded with a binary load coaaand. If you aust load and 
run the file with separate coaaands, the run address aust be 
entered as hexadecimal 76E0. 

12. When this file is run it will create another file naaed AUTORUN.SYS 
on your working diskette. This file is your ENHANCEMENTS TO BASIC 
working copy. If your DOS supports an AUTORUN.SYS file, all you 
need do is boot your working copy and ENHANCEMENTS TO BASIC will 
load and run autoaatically. As an alternative, if AUTORUN.SYS is 
not supported, you aay be able to renaae the file to BASIC.COM 

and create a startup batch file to load and run the BASIC.COM file. 

13. Depending on the type of DOS you are using, you aay have to use 

one of a nuaber of aethods to return to BASIC froa DOS. The possible 
aethods are using the [SYSTEM RESET! key, running at the hexadeciaal 
address 9333, or using the run cartridge option of your DOS. Soae 
of these aethods aay cause lockups or loss of prograas. You aust 
experiment to see which method is appropriate to your DOS. We 
recossend that you avoid using DOS while prograaaing in ENHANCED 
BASIC. It is best to save your prograa first and then call DOS. 

In this way you will not lose valuable prograas or data. 


m***iffmm*mm**m»mt**««*t*f*f«H»«f*»ttttm****tttt*iH**if»«* 



XL AND XE USERS -- AFTER YOU HAVE CREATED YOUR WORKING COPY AND ARE READY TO 
BOOT IT, BE SURE THftT YOU DO NOT HOLD DOWN THE OPTION BUTTON AS YOU TURK OH 
YOUR COMPUTER. THE ENHANCEMENTS PR06RAH AUTOMATICALLY DISABLES THE BUILT-IN 
BASIC OK XL AND XE COMPUTERS AND HILL NOT FUNCTION PROPERLY IF THE OPTION 
KEY IS HELD DOWN PURINS THE BOOT PROCESS. 


WHAT YOU SHOULD EXPECT (PROBRftH LIMITATIONS AND PRECAUTIONS) 


It should be mentioned at this point that ENHANCEMENTS TO BASIC is not 
intended to be a substitute for ATARI BASIC. It is intended to be used as a 
PROGRAMMING aid. The special features and capabilities of ENHANCEMENTS TO 
BASIC are really of very little use when running already prepared programs. 

The real value lies in what ENHANCEMENTS TO BASIC can do for you when you 
are WRITING new programs or even typing programs from a magazine. 

One other precaution which should be mentioned is that while ENHANCEMENTS TO 
BASIC is safe from destroying itself through BASIC POKE statements, it is 
not protected from machine language subroutines such as USR calls which 
change memory contents in the area where it is stored. This area extends 
fro* 36864 ($9000) to 49151 (fBFFF! in the half enhancement mode and fro* 

3276B <*8000) to 49151 ($BFFF) in the full enhancement and trace modes. 
Therefore, it would be wise to be sure you have saved to disk any program 
of value you have typed BEFORE you attempt to RUN it. Actually, even the 
cartridge version of ATARI BASIC can have a program destroyed by a single 
POKE into an improper memory location. No matter what the language, it is 
good programming procedure to SAVE your programs before trying to RUN thee. 

ENHANCEMENTS TO BASIC IS DESIGNED TO WORK WITH EITHER THE REVISION A BASIC 
CATRTIDGE iTHE ONE ORIGINALLY SUPPLIED WITH THE 800 COMPUTERS) OR THE BUILT IN 
BASIC OF THE XL/XE COMPUTERS. ALTHOUGH WE ARE UNAWARE OF ANY, THERE MAY BE SOME 
REVISIONS OF BASIC WHICH ARE NOT COMPATIBLE WITH THIS PROGRAM. IF YOU ENCOUNTER 
A SITUATION WHICH YOU FEEL IS DUE TO THIS TYPE OF INCOMPATIBILITY, PLEASE 
CONTACT US. WE WILL TRY TO WORK WITH YOU TO PROVIDE YOU WITH A WORKING PROGRAM. 


THE TITLE SCREEN 

When you first boot ENHANCEMENTS TO BASIC you will be greeted by the title 
screen. This screen gives the program name, its unique serial number, a short 
copyright notice, and the prompts to select the type of enhancement you need. 

The title bar at the top of the title screen also indicates the type of 
computer on which the program was initialized. This will be shown as either 
800 or XL/XE. A program initialized on an 800 will not function properly on 



XL or an XE. Also, a progra* initialized on an XL or XE will not function on 
an 800. A 1200XL WILL BE TREATED AS AN BOO BY THIS PROGRAM. THIS IS NORMAL. 

The last nuaber in the title bar indicates the type of DOS the progra* 
recognized at boot tine according to the fallowing table: 

0 - NO DOS RECOGNIZED 

1 - SPARTADOS 

2 - ATARI DOS 2.OS 

3 - ATARI DOS 3 

4 - ATARI DOS 2.5 

5 - OSS DOS XL 

If you see a zero here, it aeans that the DOS you are using was not recognized 
by the ENHANCEMENTS TO BASIC progra*. In this case, the progra* should still 
function properly but MAY give error sessages when trying to access so*e DOS 
functions fro* ENHANCED BASIC, 

FULL ENHANCEMENT WITH TRACE is selected with the OPTION button. This gives 
you access to all enhanceaents except the HELP screen and enables TRACE. 

The TRACE function sets up an alternate screen to which progra* lines are 
printed as they are being executed. You have coaaands available to you to 
switch between screens at any tiae. This allows you to watch your progras's 
execution for flaws or bugs and then switch to the TRACE screen to see 
which lines are the culprits. One word of caution: TRACE does soae very 
elaborate eaneuvering with *e*ory locations to keep the TRACE screen safe 
fro* progra* graphics coaaands, piayer-aissile graphics and BASIC POKE 
statesents. The ATARI is such a versatile graphics co*puter that it is not 
possible to protect the TRACE function against all the things that the ATARI 
sight do to invade the RAH area where TRACE resides. He would reco**end, 
therefore that TRACE only be activated when you have a need for it, and that 
you have your progra* saved to disk before atte*pting to RUN it with the 
TRACE function active. 


FULL ENHANCEMENT WITHOUT TRACE is selected with the SELECT button. This is 
the recossended enhanceaent *ode as long as the extra 4K of RAM it requires 
is not a problea. This sode gives you access to all enhanceaents except the 
screen trace. There is, however, a printer trace *ode available which can be 
helpful in debugging prograas. It will be explained in aore detail in the 
section on coaaands. 


HALF ENHANCEMENT WITHOUT TRACE is selected with the START button. This aode 
is recoaaended only for use with very long prograas which require the «axi*u* 
a*ount of free aeaory that is available with ENHANCEMENTS TO BASIC. The 



coaaands available in this sode have been lisited to a -few of the aost useful 
m order to conserve aemory space. 


USINS YOUR NEW COMMANDS 

ENHANCEMENTS TO BASIC takes aver forty new coaaands available for your 
programing convenience. A list of the coaaands, their proper foraat, and 
their application follows. Reaeaber, TRON and TROFF are the only additional 
prograa sode coaaands available. All other coaaands are only used in the 
iasediate aode. 


COMMANDS FOR TRAC1N6 PROGRAM FLOW 

THE F0LLDHIN6 EIGHT COMMANDS RELATING TO TRACING PROGRAMS TO THE SCREEN ARE 
ONLY AVAILABLE IN THE FULL ENHANCEMENT WITH TRACE MODE. 


TRON (IMMEDIATE MODE) 

TRON in isaediate aode causes the last contents of the TRACE screen to be 
displayed. This could be used, for instance, to see which instructions were 
being executed when your prograa was stopped by an error or the BREAK key. 
TRON will cause the norsal screen editor display to becoae invisible, but 
any coaaands you enter from the keyboard will still be carried out when 
the RETURN key is pressed. 


TRON (PROGRAM MODE) 

TRON in prograa aode causes the TRACE screen to be displayed. 


[SHIFT] [ESCAPE] 


Holding down the SHIFT key while pressing ESCAPE as a prograa is running is 
identical to TRON in the prograa aode. It causes the TRACE screen to be 
displayed. 


TROFF (IMMEDIATE MODE) 

TROFF in iaaediate aode cancels TRON and causes the noraal screen display 
to return. 



TROFF (PROGRAM MODE) 


TRDFF in prograa aode cancels TRON and causes your prograa's graphics, or 
display screen to return. 


[CONTROL! [ESCAPE] 


Holding down the CONTROL key while pressing the ESCAPE key as a prograa is 
running is identical to TROFF in the prograa node. It cancels TRON and 
causes your progras's screen display to return. 


[SHIFT] [CONTROL] [ESCAPE] 


When the RUN coaaand is given the TRACE function defaults to a condition of 
not printing data to the hidden TRACE screen, Any TRON or TROFF coaaand 
changes the default so that data are printed to the TRACE screen, This will 
cause the prograa execution to becoae a great deal slower because the 
progras aust wait while each line that is executed is printed to the TRACE 
screen. By holding down the SHIFT and CONTROL keys while pressing the ESCAPE 
key you can return to the default condition and speed up prograa execution. 
This will, however, prevent the TRACE screen froa being updated until the 
next coaaand that changes the TRACE status is encountered. 

If you should need to view a pragraa trace froa the very first line, the 
best way to proceed is to sake the first line of the prograa a TRON coaaand. 
This will prevent loss of any trace data on the TRACE screen. 


[ESCAPE! 

The ESCAPE key has the reverse effect of [SHIFT] [CONTROL] [ESCAPE], It will 
cause the trace screen to start being updated but will not change the TRACE 
status. If TRACE is in effect, it will reaain in effect. If TRACE is not in 
effect, it will reaain disabled, but prograa execution will be slowed down 
due to the updating of the invisible TRACE screen, 

f}**t***tft)tmf**m*i*t*t**m*4*t*m****»****t»ti****t****ti*t*****tt*t 

THIS CONCLUDES THE COMMANDS AVAILABLE ONLY IN FULL ENHANCEMENT WITH TRACE. 
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LNUHB (LIST ONLY LINE NUMBERS) 


LNUHB will cause only the numbers of program lines to be displayed when doing 
a program trace or yariable search. 


LLINE (LIST ENTIRE LINES) 

LLINE will cancel LNUHB and cause the entire line to be displayed when doing 
a program trace or variable search. 


[SYSTEM RESET] 


Mith certain programs having elaborate graphics and also with certain 
combinations of immediate and program mode IRON and TRQFF commands, you may 
be unable to return the screen display to normal. In these instances use the 
[SYSTEM RESET] key to reinitialize the screen editor and the TRACE -function. 

The ENHANCEMENTS TO BASIC program is protected from the [SYSTEM RESET] key and 
should be as safe fro® it as the normal ROM version of ATARI BASIC. One word 
of caution is necessary here - check the specific startup instructions for your 
DOS at the beginning of this manual for information on using [SYSTEM RESET] 
while in DOS. In some cases it can cause a system lockup. 


COMMANDS TO ENHANCE PRQ6RAHMIN6 

THE COMMANDS FROH THIS POINT TO THE END OF THE COHHAND LIST ARE AVAILABLE IN 
THE FULL ENHANCEMENT WITHOUT TRACE NODE. 


NUN (AUTO LINE NUMBERING) 

NUH causes line numbers to be automatically printed at the beginning of 
each line of programming. The default condition is to number in increments 
of 10 starting at 10 above the last line number currently in use. 

NUH x starts numbering at x above the last line number used. The increment 
is also x. 

NUH x,y starts numbering at line number x with an increment of y. 

For example, NUH 100,25 will start numbering at line 100 and increment each 
line by 25. (100, 125, 150, etc.! 




You can even insert nuabers between esisting prograa lines, When an existing 
line nuaber is encountered the auto line nuabering is cancelled and the 
READY prompt is shown. Also, any error in a prograa line will cancel the 
auto line nuabering and print the error line so that corrections can be 
aade. 

To cancel auto line nuabering you need only press RETURN on a line with no 
prograa data except the line nuaber. 

The BREAK key will cause the current line nuaber to be skipped but you will 
reaain in the auto line nuaber mode. This can be used to reserve a block 'of 
prograa lines for inserting data at a later ti*e. 

CAUTION—If you are in the auto line nuabering aode and atteept to use the 
cursor control keys to aove the cursor away froa and back into the current 
PHYSICAL line, the line nuaber will be duplicated and an error aessage will 
result. If you are typing in the second or third physical line of a logical 
line and notice an error that requires an up or down cursor soveaent, the 
best solution is to finish the line, press RETURN twice to enter the line 
and exit the auto nuaber aode, then correct the line and reenter the auto 
line nuaber aode using the NUM coaaand. 

This problea is due to a bug in the ATARI operating syste# and is not due to 
the ENHANCEMENTS TO BASIC prograa. (Users of the ASSEMBLER EDITOR CARTRIDGE 
and MICROSOFT BASIC should be aware of this problea since the saae operating 
syste* bug affects the® also. 


REN (RENUMBER PROGRAM LINES) 


REN is the default coaaand. It causes all prograa lines to be renuabered 
using 10 as the first line nuaber and increaenting each following line by 10, 

REN x,y,z causes prograa lines to be renuabered starting at line x, 
changing line x to line y and increaenting each line after that by z. For 
exaaple, REN 200,500,20 would renuaber your prograa starting at line 200. 

Line 200 would be changed to 500 and each line following would be increaented 
by 20. (180, 190, 200, 210, 220 would becoae 180, 190, 500, 520, 540 etc.) 

Even if only part of a prograa is renuabered, references to line nuabers in 
the part which is not renuabered are also corrected to reflect the new line 
nuabers. 

Line nuaber references containing variables cannot be renuabered. To aake it 
easier for you to check these references, a list of up to 125 such lines 
will be displayed when renuabering is coapleted. In the unlikely event that 



you have more than 125 lines with variable line number references in your 
program, the best solution is to insert REM statements at the beginning of 
some of the first problem lines in the program. The RENuaber routine will 
then ignore these lines and be able to list the additional problem lines at 
the end of the program. As long as there are more problem lines than the 
RENuaber routine is able to list, the aessage 'PLUS MORE' will be displayed 
at the end of the line list. 

Line nuabers which are referenced but do not exist will not be renuabered, 

CAUTION—If you delete lines from a prograa you should try to verify that 
none of the deleted lines were referenced by a SOSUB, BOTO, etc. coaaand in 
the remainder of the prograa. If you find any such references, they should be 
corrected before using the RENUMBER coaaand. If they are not corrected the 
renuabering process aay recreate the line nuabers and cause soee difficult 
to correct prograa bugs to appear. 

NOTE—In lines containing aultiple statements, the renuaber coaaand will list 
a line number to be checked tor EACH STATEMENT containing a problem line number 
reference. In renumbering a line such as 10 SOSUB A: BOSUB B: BOSUB C, the 
number 10 lor the number to which 10 is changed) will appear three tiaes in 
the list when ^numbering is completed. 

If renuabering cannot be completed due to aeaory liaitations, the aessage 
'CANNOT RENUMBER' will be displayed and your prograa will not be changed. 


SOME ADDITIONAL NOTES ON RENUMBERING 


The table of probiea lines which is displayed at the coapletion of renuabering 
also includes those lines which reference nonexistant line nuabers. The key 
word to reaeaber is NONEXISTANT. Consider renuabering the following prograa 
with the default command REN. 

1 SOTO 30 

2 REM 

3 END 

When renuabering is coapleted, the prograa will read: 

10 GOTO 30 
20 REM 
30 END 

Since line 30 did not exist at the tiae line 10 was renuabered, line 10 will 
be displayed as a problem line number. Reaeaber, a probiea exists even though 



the program now appears correct. Since line 30 was created by the renumbering 
process, the proqraa will not branch to the location originally intended. 

Now consider renumbering this proqraa: 

1 REN 

2 GOTO 10 

3 END 

Line 1 will be renumbered first and will be changed to line 10. When line 2 is 
renumbered, line 10 already exists (it was line 1) and the renuaber command 
will not detect an error. An error does exist, however, and can cause soae 
very confusing results. For this reason, when you have deleted lines, you aust 
verify that there are no references to sissing lines in your prograa BEFORE 
you renuaber it. 


VER (VERIFY A BASIC PR06RAH) 

The most practical way to verify a prograa before renuabering is to renuaber 
an area above your highest line nuaber. For exaaple, if you issue the coaaand 
REN 32767,32767,1 your program will be checked for syabolic references and 
aissing line numbers but no line numbers will be changed. You can then correct 
any problem line references and issue the renuaber command again in whatever 
increaents you choose. The VER coaaand does this for you with a ainiaui 
amount of typing. 


?DEL (DELETE A BLOCK DF LINES) 

!DEL x will delete line x. The exdaaation point (!) before the command aust 
be included. This is a precaution against accidentally deleting soae of 
your program. In fact all coaaands which aay cause prograa daaage if not 
properly used must have the exdaaation point before thea. 

!DEL x,y will delete lines x through y inclusive. 

CAUTION—If the y argument is greater then 32767 it will be ignored and only 
line x will be deleted. 


DIR (EXAMINE THE FILE DIRECTORY) 


DIR will display the file directory for the diskette in drive one. 


DIR x will do the saae for drive x. 


RENAHE (RENAME A DISKETTE FILE) 


RENAME "D#:OLDNAHE.EXT,NEWNhHE.EXT" is the forsat of the coaaand to renaae 
a diskette file. You sust substitute the nuaber of the drive you wish to 
access in place of the # syabol (or use D: for drive one). You aust also 
substitute the original filenaae for OLDNAHE.EXT and the new filenaae for 
NENNAME.EXT. If you use the SINGLE coaaand RENAME will only renaae the first 
file it finds that Batches your filespec. This aak.es it easy to recover fros 
duplicate filenaaes if they should ever occurr. 


LOCK (LOCK A DISKETTE FILE) 

LOCK "D# FILENAME.EXT" is the forsat of the coaaand to lock a diskette file. 
You aust change FILENAME.EXT to the nase of the file you wish to lock and 
change the # syabol to the nuaber of the drive you wish to access (or D: to 
access drive 1). 


UNLOCK (UNLOCK A DISKETTE FILE) 

UNLOCK “D#:FILENAME.EXT" is the forsat of the coaaand to unlock a diskette 
file. You aust change FILENAME.EXT to the naae of the file you wish to 
unlock and change the # syabol to the nuaber of the drive you wish to access 
(or D: to access drive 1). 


!ERASE (ERASE A DISKETTE FILE) 


1 ERASE "D#:FILENAME.EXT B is the foraat of the coaaand to erase a diskette 
file. Be careful with this coaaand as it does not ask for verification of 
your filespec or your desire to erase. If you should accidentally erase a 
file you wanted to keep, you can use RESTORE to get it back. As with the 
previous coaaands of this type, you aust substitute the nuaber of the drive 
you wish to access for the # syabol and change FILENAME.EXT to the naae of 
the file you wish to erase. 


iSDF (FORMAT A DISKETTE IN SIN6LE DENSITY) 

ISDF "D#:” is the foraat of the coaaand to foraat a diskette in the drive 
specified by the # syabol (or drive 1 if only D: is typed). The ISDF coaaand 
will foraat in single density. Be EXTREMELY careful with this coaaand as it 
dies not ask for any verification of your intent to foraat a diskette or the 
drive nuaber you wish to access. 


!DDF (FORNAT A DISKETTE IN 1050 DOUBLE DENSITY) 


iDDF follows the saae format as the !SDF caasand. It will foraat a diskette 
in 1050 double density if your DOS and disk drive support this density. 


IPROT (PROTECT A BASIC PR06RAH) 


IPROT will alter your progras so that it is unreadable but will still 
execute properly. Be sure you have saved a copy of your prograa before using 
IPROT because editing is ispossible on a protected progras. 

IPROT "D#:FILENAME.EXT“ will protect your prograa and also save it to a 
diskette under the filenaae you specify in place of FILENAME.EXT. CAUTION- 
The file saved by this cotaand will also be in the protected foraat and say 
only be RUN and not listed or edited. 


LVAR (LIST THE VARIABLES IN A BASIC PROBRAN) 


LVAR will display a list of the variables used in your prograa. This can aid 
in finding unused variable naaes which say have crept into your prograas. 


SVAR (SEARCH FOR LINES C0NTAININ6 A SPECIFIED VARIABLE) 

SVAR "var" will search a BASIC prograa for all lines containing the variable 
specified within the quotation aarks. By using various cosbinations of the 
DUMP, SCREEN, LLINE, and LNUHB coaaands, you aay list entire lines or only 
line nuabers to either the screen or a printer. SVAR can be a great help in 
editing a prograa when you need to find and aodify all the lines containing 
particular variables. If the variable you search for does not exist, the 
aessage 'var DOES NOT EXIST' will be displayed. If the variable exists in 
the variable naae table but is not used in your proqraa, the aessage 'var 
IS NOT USED IN PROBRAN' will be displayed. 


CVAR (CHAN6E A VARIABLE NAHE) 

CVAR "old,new’ will change all references to the variable specified by the 
old paraaeter to the one specified by the new paraaeter. CVAR "AA,BB" will 
change variable AA to variable BB at all locations in your prograa. If the 
variable you specify by the old paraaeter does not exist, the aessage 'old 
DOES NOT EXIST' will be displayed. 

CAUTION—It is possible to renaae a variable to just about anything that can 


be displayed on the screen (except inverse characters) with the CVAR cosaand. 
BASIC, however, will only recognize certain characters as legal variable 
nases, H you change a variable to sosething which BASIC will not allow, your 
prograa will still RUN, will LIST to the screen properly, and can even be 
SAVEd or LOADed, However, you will not be able to edit lines or ENTER the 
prograa again alter having LISTed it to a storage device. This could be used 
as a protection device to keep others from decoding or modifying your 
proqraas. If string variables are renamed as nutieric, etc, a prograa will 
still execute properly but will be nearly impossible to analyze or decode. 

Just be sure to save an unsodified copy for your own use or you say find that 
you are unable to understand or sodify your own program! 

ANOTHER CAUTION—It is possible to reaove variables cospletely fro* the VNT 
(Variable Nase Table! with the CVAR co*»and. If you enter the coaaand CVAR 
“old," (note that there is no new variable nase) the variable specified by 
the old paraseter will be deleted fro* the VNT cospletely. This will cause 
all the variables frot that point on in the VNT to be offset fro* their proper 
location. Your progra# will still execute properly, but it will be confusing 
to read. The best solution here is to be careful with the CVAR cosaand unless 
you are intentionally trying to scrasble a prograa as a aeans of protection. 

ONE FINAL CAUTION—Do not try to change a variable to anything containing 
inverse characters. If you do, each inverse character will be interpreted by 
BASIC as the final character of a variable naae. For the following exaaples 
assume that the italic characters signify inverse characters. If you were to 
give the cosaand CVAR "old,ff£)f" the variable old would be replaced by the 
three variables N, E, and W. An interesting consequence of this is that it 
is possible to insert variables at specific points in the VNT. (ATARI BASIC 
adds all new variables at the end of the VNT.) Assuaing again that the italics 
are really inverse characters, the coaaand CVAR‘old,oldnew" would retain the 
variable old in the VNT and add the variable new immediately after old. This 
could be used to restore an accidentally deleted variable to the VNT as long 
as the proper location were known. 

The foregoing discussion requires an in-depth knowledge of ATARI BASIC to 
understand thoroughly, but you can do no har* if you have your progra* saved 
to a disk so why not experisent and see what happens. You might gain sose new 
knowledge about the internal workings of ATARI BASIC. 


!DOS (ACCESS DOS) 


!DOS allows you to access DOS. With ENHANCEMENTS TO BASIC *ost DOS coa#ands are 
available fro* BASIC so it is best to avoid DOS unless absolutely necessary. 

The noraal DOS coasand is trapped in both iaaediate and prograa aode to help 
keep you froa accidentally destroying your prograa. If you try to access DOS 



froa the keyboard without the exdasation point before the cossand, or fro« 
a prograa in the noraal way the screen will dear and the aessage 'DOS 
INTERCEPTED' will be displayed. H the DOS coaaand was during prograa 
execution, the line nusber of the DOS coaaand will also be displayed. 


DUMP (SEND ANYTHING WHICH GOES TO THE SCREEN EDITOR TO THE PRINTER INSTEAD) 


DUMP reroutes all output which would noraally go to the screen editor to the 
printer instead. It can be used to print disk directories, prograa traces, 
variable naae lists, and prograa responses to the printer instead of the 
display screen. 

For exaaple, the coaaand sequence DUMP [RETURN! LVfiR [RETURN! would print a 
list of all prograa variables to the printer instead of the screen. The 
coaaand sequence DUMP [RETURN] DIR [RETURN! would print a directory of the 
diskette in drive one to the printer. DUMP reiains in effect until it is 
cancelled by a SCREEN coaaand or by SYSTEM RESET. 


SCREEN (RESTORE SCREEN EDITOR OUTPUT TO THE DISPLAY SCREEN) 


SCREEN cancels the DUMP coaaand and routes data back to the display screen. 


LMAR# (SET THE LEFT MAR6IN TO ft) 

LMAR# will set the left sargin to the value specified by the # paraaeter. 
This can be of value if your display screen suffers froa overscan such that 
soae characters are not visible on the left side of the screen. In this case 
you could change the default sargin of two to five or six so that the entire 
line would be visible to you. The left and right aargins say be set to values 
fros 1 to 40. SYSTEM RESET restores the default values. 


RHAR# (SET THE RIGHT MARGIN TO ») 

RMAR# will set the right sargin to the value specified by the # paraaeter. 
The sase reasoning as described above for the left sargin also applies here. 


IRUNAT# (RUN AT ADDRESS #) 


IRUNAT# is the equivalent of DOS option M (RUN AT ADDRESS). iRUNAT# will jusp 
to a sachine language subroutine at the address specified by the # parameter. 
If the routine ends in an RTS instruction, control will be returned to BASIC. 


!POKE x,y (POKE ft VALUE INTD THE PROTECTED HEHORY AREA) 


'POKE s,y will poke the value y into aeiory location x without regard to 
whether location x is a protected area of aemory. THIS COMMAND SHOULD BE USED 
NITH GREAT CAUTION AND ONLY IF YOU ARE FAMILIAR WITH BASIC AND ENHANCED BASIC 
SOURCE CODE. IMPROPER USE OF THE IPOKE COMMAND CAN RESULT IN A SYSTEM LOCKUP 
AND THE LOSS OF ANY PROGRAM IN MEMORY. 

The normal POKE coasand is trapped in both isaediate and prograa aode for 
any eeaory locations which are reserved by ENHANCEMENTS TO BASIC. If you 
attempt to POKE into protected aesiory, the screen wili clear and the aessage 
‘POKE INTERCEPTED' will be displayed. If the POKE was during progra® 
execution the line nunber of the POKE coaaand will also be displayed. 


LKB (LOCK THE KEYBOARD) 

LKB will lock the keyboard to prevent unauthorized or curious people fro® 
causing daaage to your prograas or data when you mist be away fro® the 
CGsputer for a aoaent or two. To unlock the keyboard the proper three digit 
code «ust be entered. The default code to unlock the keyboard is to press 
the numbers one, two and three in sequence while holding down both the SHIFT 
ana CONTROL keys. 


KEY'abc" (SET ft NEW COSE TO UNLOCK THE KEYBOARD) 

KEY'abc" wili change the default unlocking code to the three characters 
represented by the abc within the quotation Barks. You nay use any keystrokes 
which wili produce a character on the display screen as part of your unlocking 
code. We recoasend that if you change the code, you should use a code you 
will not easily forget. The keyboard lock is pickproof! If you forget your 
code you will have to turn off the conputer and start over. 


KDELtt (SET THE KEY DELAY TO i) 

KBEL# will set the delay before a key begins to repeat to the value specified 
by the # paraaeter. The default value is 4B. Values lower than ten usually 
result in typing errors because the keys will repeat in nortal typing. A 
value of zero will cause the auto repeat to be disabled. SYSTEM RESET will 
restore the default value of 43. 



KREP# (SET THE AUTO KEY REPEAT RATE TO #) (XL/XE ONLY) 


KREP# will set the auto repeat rate to the value specified by the # paraseter. 
The default value is six. Values lower than three are generally unusable. 

The default value is restored by SYSTEM RESET. 


NQCLICK (TURN OFF THE KEYCLICK) (XL/XE ONLY) 

NOCLICK will turn off the keyboard click without turning down the voluae on 
the T.V. or aonitor. 


CLICK (TURN ON THE KEYBOARD CLICK) (XL/XE ONLY) 

CLICK cancels NOCLICK and turns the keyboard click back on. 


HELP (DISPLAY THE HELP SCREEN) 

HELP will display two pages of inforaation on coaaands and proper foraat. 

In depth detail is not provided. This is, instead, a listing of proper foraat 
for aost coaaands and a short description of soae. 


HEK (OUTPUT NUMERIC VALUES IN HEKftDECIHftL) 

HEX will cause all integers between 0 and 65535 other than those in REHark 
and DATA stateaents to be displayed in hexadeciaal. The listing will revert 
back to deciaal for negative nuabers, nuabers greater than 65535, and 
fractions. After all, how aany of us can understand a hexadeciaal fraction? 

The listing of a hexadeciaal nuaber follows the standard convention of placing 
a $ (dollar sign) before the nuaber to indicate that it is hexadeciaal. 


DEC (OUTPUT NUMERIC VALUES IN DECIMAL) 


DEC cancels HEX and returns progra* listing of nuaeric values to noraal. 


DEF#'string* (DEFINE KEY* AS string) 

The keys 4, 5, 6, 7, 8, 9, and 0, when used in conjunction with the CONTROL 
or CONTROL and SHIFT keys can be used to print strings of characters to the 
screen. The default values of these keys are as follows: 








CONTROL 4 = LOAD H D: 

CONTROL 5 = SAVE "D: 

CONTROL a = LIST 

CONTROL 7 = RUN 

CONTROL 3 -- PONE 

CONTROL 9 = PEEK ! 

CONTROL 0 = DATA 

SHIFT CONTROL 4 = PLOT 
SHIFT CONTROL 5 = DRAHTQ 
SHIFT CONTROL 6 = LOCATE 
SHIFT CONTROL 7 = POSITION 
SHIFT CONTROL 8 = COLOR 
SHIFT CONTROL 9 = SETCOLOR 
SHIFT CONTROL 0 = GRAPHICS 

In addition, the keys from 4 to 9 when used in conjunction with SHIFT and 
CONTROL can be rede-fined as strings of up to 30 characters. The 0 key, in the 
saae manner, can be redefined to represent up to 62 characters. 

DEF# a string" will redefine the key specified by the # paraseter to represent 
the characters specified by the string paraseter. You say use almost any 
character which will display on the screen within the string parameter. If 
you use escape sequences or cursor control codes within the string parameter, 
they will display rather than execute when you use a redefinable key. The 
ability to redefine keys can be very useful when you must repeat the same 
data (especially printer control codes using unfamiliar graphics characters) 
many times within the same program. As an example, if you type DEF4“FIRST 
BYTE", our' name will be printed to the screen each time you press the 4 key 
while holding down the SHIFT and CONTROL keys. 

DEF#"' will clear the key specified by the # parameter so that nothing is 
printed to the screen when that key is pressed in conjunction with SHIFT and 
CONTROL. 


PTRON (ENABLE PRINTER TRACE) 

PTRON will enable a program trace to the printer and not the display screen. 
With the printer trace TRQN and TROFF in program mode function as described 
previously under the screen trace. TRON and TRDFF are not available in the 
immediate mode with the printer trace. Also, [CONTROL! [ESCAPE! AND [SHIFT] 
[ESCAPE] serve the same purpose as with the screen trace. 

It is recommended that PTRON not be used except when it is really necessary, 
and that you have your program SAVEd before using the PTRON command. 



PTROFF (DISABLE PRINTER TRACE) 


PTROFF disables the printer trace and returns operation to normal. This is 
the default condition. 


(HALF (FREE HEHORY TO SAVE A PR06RAH) 

It is possible with large prograas to encounter a situation in which you are 
unable to save a proqraa to disk because of an out of aeaory error. If this 
happens in the FULL ENHANCEMENT or TRACE aode, you can type !HALF [RETURN] 
to free enough aeaory to allow you to save your prograa. You aust save your 
prograa to disk iaaediately after using the (HALF coaaand. You should then 
reboot the systea and enter the HALF ENHANCEMENTS aode. If the saae problea 
occurrs in the HALF ENHANCEMENT aode, try typing CLR [RETURN] and then 
pressing [SYSTEM RESET]. If you are still unable to save your prograa, you 
aust then delete at least one line of the prograa in order to free enough 
aeaory to enable you to save it. 


(COLD (COLDSTART THE COMPUTER) 


Typing (COLD is equivalent to turning the power switch off and then on. It 
should only be used to leave ENHANCED BASIC and boot a new disk. Using the 
(COLD coaaand will eliainate the power surges associated with switching the 
power off and on. 


RESTORING DELETED FILES 

If you are using ATARI DOS 2.OS you can access a prograa on your ENHANCEMENTS 
TO BASIC aaster diskette which will restore accidentally deleted files as long 
as they have not been written over with new data. The prograa is naaed RESTORE 
and aust be loaded with the L (BINARY LOAD) option of the DOS aenu. Once the 
file is loaded it is self explanatory. You need only follow the proapts to ' 
accoaplish your desired result. If a file has been daaaged and cannot be 
restored, an ERROR 164 will be returned. Reaeaber, the RESTORE proqraa only 
works with ATARI DOS 2. OS. 


COMMANDS AVAILABLE WITH HALF ENHANCEMENT 

THE FOLLOKINS COMMANDS ARE THE ONLY ONES AVAILABLE IN THE HALF ENHANCEMENT 
MODE. SEE THE PREVIOUS LISTING FOR A DESCRIPTION OF THEIR USE. 



RENAME 

REN 

DIR 

RESTORE 
LOCK 
!FORMAT 
SCREEN 


NUM 

! DEL 

DDIR 

DRENAHE 

UNLOCK 

DUMP 

!ERASE 


OTHER PRQ6RAH CHARACTERISTICS 

ENHANCEMENTS TO BASIC has several other Features to sake your prograaaing 
safer and easier. The sost isportant is that the docusented causes of systes 
lockups have been corrected. This should aean that you will not be subjected 
to accidental lockups when you are trying to edit that thousand line program 
you just finished and have not yet saved! Of course we cannot guarantee that 
there is NO POSSIBILITY of a lockup, but we HAVE fixed all the known causes. 

He have also fixed the 16 byte sesory expansion bug of REVISION B BASIC. 

IF YOU ARE A SKEPTIC — And don't believe that the editing lockup probles on 
the ATARI 800 can be fixed, or perhaps don't believe that there is a lockup 
probles) an the ATARI 800XL, you should try the following prograas. 

To demonstrate the editing lockup probles on the ATARI BOO enter the following 
program. (Lines 20 and 30 each have 107 asterisks and line 40 has 18 asterisks. 
Your count must be exact on these lines!!) 

BE SURE TO TYPE NEW [RETURN] BEFORE ENTERING THIS PROGRAM. 

10 REM 

20 REM *mm*H**m*HHti*m**t** 
*Hmmt*m*»*mf****tftm*«»*tt* 

30 REM **Hmim***i*m***»**m*** 

40 REM H*tt*tm***t*#*t 

Now type LIST [RETURN] to list the prograa. THIS STEP IS IMPORTANT!! 

Next delete line 10 - just type 10 and press [RETURN]. 

If you are using standard ATARI BASIC your computer should now be in a lockup 
condition. With ENHANCED BASIC, of course, it should be functioning properly. 


To demonstrate the editing lockup problea on the 800XL enter the following 



program. (Lines 10 and 20 each have 107 asterisks and line 30 has 17 asterisks. 
Your count #ust be exact on these lines!!) 

BE SURE TO TYPE NEW [RETURN] BEFORE ENTERING THIS PROGRAM. 

10 REN *«♦******»**#»**««*♦**«**** 

***i*tfm**«*m*tti*f*it**«tttt*f*<f 

******tit*t***m*ttt**t*i«tt*ttt*ft«t 

20 REN 

***t**f»«t*t***Hitit*t***m « ******* 

***t«tt«*ff*************************** 

30 REM HHHHHHHHl 

Now type LIST [RETURN! to list the program THIS STEP IS IMPORTANT!! 

Next type A=1 and press [RETURN!. As before, with standard ATARI BASIC your 
computer should be in a lockup condition. However, with ENHANCED BASIC, it 
should function properly. 

ENHANCEMENTS TO BASIC also allows you to enter numeric values in either 
decimal or hexadecimal. Hexadecimal numbers in the range 100 to IFFFF are 
accepted as valid. To enter a number in hexadecimal you need only prefix it 
with a t (dollar sign). 

If you enter values in hexadecimal, they will be converted internally to the 
standard ATARI BASIC format so that your programs will still be compatible 
with other ATARIS which may not be using ENHANCED BASIC. The one exception 
to this rule is that numbers in DATA statements are not converted and should 
be entered in decimal to maintain compatibility with other ATARIS. 

The ability to accept and print out numbers in decimal or hexadecimal also 
makes an unusual type of calculator available to you. If you type a line in 
immediate mode such as PRINT $EA+$A6E the computer will do the math for you 
and print out the answer in decimal or hexadecimal depending on which mode 
you are currently in. You may do any type of math the ATARI is capable of, 
entering your numbers in decimal, hexadecimal, or any combination of both. 

Your results can be either in decimal or hexadecimal. To obtain a hexadecimal 
result the number must be a positive integer between 0 and 65535. Any number 
which does not meet these requirements will automatically revert to decimal. 

Error messages in ENHANCED BASIC are presented as English phrases in addition 
to the error number. Running certain programs may cause only the error number 
to be listed, but this will cause no damage to your program or ENHANCED BASIC. 

If you are an 0NNIN0N user, you will find that going to 0MNIM0N does not 
damage ENHANCED BASIC so long as you return to basic with the SYSTEM RESET 


key and have not changed any critical memory values while in OMNIMON. 

rou should not use the DOS menu -fro* ENHANCED BASIC to load any binary load 
prograas which are keyboard interactive. The Special keyboard handler used 
by ENHANCED BASIC will still be in effect and can cause soae very strange and 
obscure problems to occurr. 

In order to «ake room for the TRDN and TROFF coiaands in the prograa aode, 
CSAVE and CLQAD are now only supported in the iaaediate aode. If you try to 
use CSAVE or CLOAD in the prograa aode they will be treated as invalid 
coaaands and an error will result. 

You should remember to reaove any prograa lines containing TRON or TROFF 
coaaands before saving the final version of any prograa you are writing. This 
will ensure that your prograas will be compatible with the standard ATARI 
BASIC and also with ENHANCED BASIC. 

The READY proapt for ENHANCEMENTS TO BASIC has been modified to indicate the 
type of enhancement you are currently using. The letter T indicates trace. 

The letter F indicates full, and the letter H indicates half. 

When using the TRACE function, the [SHIFT], [CONTROL!, and [ESCAPE! keys will 
override the program aode TRON and TROFF commands. For instance, if you have 
inserted TRON and/or TROFF coaaands into your prograa and then use any of the 
[SHIFT!, [CONTROL!, [ESCAPE! combinations to start or stop a trace, the 
prograa aode commands will be masked and will not function. If this should 
happen, you can press the space bar to give the program mode commands priority 
again. 


It is possible (but unlikely) for an immediate mode command which encounters 
an error to give an improper or nonexistant line number as the location of 
the error. If this should happen, type LIST 0 [RETURN! to reset the BASIC line 
pointers and try your immediate mode line again. 

ENHANCEMENTS TO BASIC does not use any of page six memory and does not alter 
the MENLO pointer. These areas are free for your programming use. 

REMEMBER—Some programs may not function properly in the FULL ENHANCEMENTS 
WITH TRACE mode. Do not use this mode unless you have a specific need for it. 

If you do use it, be sure you have saved your program to disk before attempting 
to RUN it. 

We wish to emphasize one final time that ENHANCEMENTS TO BASIC is designed as 
a programming aid and not as a substitute for ATARI BASIC. It can be a great 
help to you in writing and editing programs, and even examining the operation 
of prograas others have written. It offers no real advantage simply running 



game or utility progress. Used in the proper Banner, we believe you will find 
that ENHANCEMENTS TO BASIC is one at the most useful prograss and one of the 
best values you will ever find for the ATARI computer. 


QUR GUARANTEE 

HE GUARANTEE THAT YOU HILL RECEIVE A WORKABLE PROGRAM THAT YOU HILL BE 
PLEASED HITH. IF YOU ARE NOT PLEASED, LET US KNOW HITHIN THIRTY DAYS OF THE 
INVOICE DATE AND HE HILL HAKE ARRANGEMENTS FOR A FULL REFUND OF YOUR PURCHASE 
PRICE. HE CAN TAKE NO RESPONSIBILITY FOR ANY LOSS OR DAMAGE BEYOND THE 
PURCHASE PRICE OF THIS PROGRAM. IT IS YOUR RESPONSIBILITY TO ENSURE THAT 
YOU ARE PROTECTED AGAINST ANY DATA LOSS BY HAVIN6 BACKUP COPIES OF IMPORTANT 
DATA AND PROGRAMS. 


FIRST BYTE reserves the right to lake changes and improvements to ENHANCEMENTS 
TO BASIC without incurring any responsibility to make the same changes and 
improvements to programs previously sold. 


ATARI is a trademark of ATARI, INCORPORATED 

DOS XL is a trademark of OPTIMIZED SYSTEMS SOFTHARE, INCORPORATED 

SPARTADOS is a trademark of ICD, INCORPORATED 


The ENHANCEMENTS TO BASIC program and manual are copyrighted by: 


FIRST BYTE 
P. 0. BOX 32 

RICES LANDING, PENNSYLVANIA 
412-627-3596 


